home *** CD-ROM | disk | FTP | other *** search
/ Business & Presentations / Business and Presentations - Volume 1 (1995)(Sideface)(NL).iso / drivers / dvialw / dviman < prev   
Text File  |  1989-05-31  |  39KB  |  973 lines
  1. DVIxxx --- TeX DVI to device xxx translator family
  2.  
  3. 
  4. File: dviman  Node: synopsis, Prev: name, Up: top, Next: description
  5.  
  6. SYNOPSIS
  7. ========
  8.  
  9.  
  10. dvixxx [-a] [-b] [-c#] [-d#] [-eVAR=value] [-ffontsubfile]
  11.        [-l] [-m#] [-o#] [-o#:#] [-o#:#:#] [-p] [-q] [-r#] [-s#] [-v]
  12.        [-x#units] [-y#units] [-z] dvifile1 [ dvifile2] ...
  13.  
  14.  
  15. xxx = output device identifier suffix (see below)
  16.  
  17. 
  18. File: dviman  Node: description, Prev: synopsis, Up: top, Next: devices-supported
  19.  
  20. DESCRIPTION
  21. ===========
  22.  
  23. Several TeX DVI translators are available.  They all expect the
  24. name of the DVI file on the command line, and the extension
  25. `.dvi' can always be omitted.  As illustrated below, they issue a
  26. one-line identifier message and, if no command line arguments are
  27. given, type a Unix-style usage message.  Some of them may have
  28. additional help files.  On case-sensitive file systems, file
  29. names may be expected to be entirely in lower case, so you should
  30. type `dvialw' instead of `DVIALW'.
  31.  
  32. For all except DVIBIT (which is intended for interactive
  33. display), the output file will be given the name of the
  34. `.dvi' file, but extension `.dvi-xxx', where `xxx'
  35. is the three-character mnemonic for the translator program.  If
  36. long extensions are not supported, then `.xxx' is used.  For
  37. DVIBIT, output is on `stdout' which defaults to the
  38. terminal; it may be redirected in the usual Unix fashion by
  39. `>filename' on the command line (e.g. `dvibit foo
  40. >foo.out').
  41.  
  42. As each `.dvi' file is processed, a list of errors is printed on
  43. the standard error unit `stderr'; this list is also saved in a
  44. file with extension `.dvi-err', or if long extensions are not
  45. supported by the host, then extension `.err' is used.  This file
  46. is not created if there are no errors.  As each page is printed,
  47. the physical page number and the TeX page number(s) are printed
  48. without a following carriage return; after the last page, the
  49. string `[OK]' is printed, followed by a carriage return.  This
  50. gives a convenient progress report to the terminal.  If it is not
  51. wanted, then the error output can be redirected into a file
  52. (possibly the null device) (e.g.  `dvixxx foo &foo.err'), or the
  53. -q option can be given to suppress it.
  54.  
  55. These drivers are written in C, and with C preprocessor
  56. conditional compilation features, are all derived from one
  57. master set of files, so that there is substantial code
  58. sharing among them.  Host machine and output device
  59. dependencies are parametrized to allow easy movement to new
  60. hosts and new output devices.  Implementations now exist on
  61. Gould UNIX, Hewlett-Packard UNIX, PC DOS, TOPS-20, VAX UNIX,
  62. and VAX VMS, with others in progress.
  63.  
  64. 
  65. File: dviman  Node: devices-supported, Prev: description, Up: top, Next: options
  66.  
  67. DEVICES SUPPORTED
  68. =================
  69.  
  70. The available translators are as follows:
  71.  
  72. DVIALW     
  73.      PostScript (Apple LaserWriter)
  74. DVIBIT     
  75.      Version 3.10 BBN BitGraph terminal
  76. DVICAN     
  77.      Canon LBP-8 A2 laser printer
  78. DVIGD     
  79.      Golden Dawn Golden Laser 100 printer
  80. DVIIMP     
  81.      Imagen imPRESS-language laser printer family
  82. DVIJEP     
  83.      Hewlett-Packard Laser Jet Plus
  84. DVIJET     
  85.      Hewlett-Packard Laser Jet
  86. DVIL3P     
  87.      DEC LN03 Plus laser printer
  88. DVIL75     
  89.      DEC LA75 144 dpi printer
  90. DVIM72     
  91.      Apple Imagewriter 72 dpi printer
  92. DVIMAC     
  93.      Apple Imagewriter 144 dpi printer
  94. DVIMPI     
  95.      MPI Sprinter 72 dpi printer
  96. DVIO72     
  97.      OKIDATA Pacemark 2410 72 dpi printer
  98. DVIOKI     
  99.      OKIDATA Pacemark 2410 144 dpi printer
  100. DVIPRX     
  101.      Printronix 60h  x  72v dpi printer
  102. DVITOS     
  103.      Toshiba P-1351 180 dpi printer
  104. DVITYP or DVITYPE     
  105.      DVI Translator for human-readable output
  106.  
  107. 
  108. File: dviman  Node: options, Prev: devices-supported, Up: top, Next: sample-execution
  109.  
  110. OPTIONS
  111. =======
  112.  
  113. The order of command options and DVI file names is not
  114. significant; all switch values apply to all DVI files.  DVI files
  115. are processed in order from left to right.
  116.  
  117. Letter case is ignored in option switches: -A and -a are
  118. equivalent.
  119.  
  120. -a     
  121.      Implement virtual font caching, if possible.  When a font
  122.      file is opened, a buffer is allocated to contain the entire
  123.      file, and the file is then read with one system call.  This
  124.      is important primarily on networked file systems, where the
  125.      many random-access calls in the font file for small amounts
  126.      of data entail substantial network overhead.  With the
  127.      entire file cached in local memory, this overhead is
  128.      removed.  The additional memory required for the font file
  129.      buffers amounts to 100K to 200K bytes (assuming the compact
  130.      .PK font file format), which is not excessive.  If memory
  131.      cannot be allocated for a font file, then normal buffering
  132.      of small blocks is used.  A trace option (-d64) is provided
  133.      to monitor the font caching; see below.
  134.      
  135. -b     
  136.      Backwards order printing from the default.  For example,
  137.      laser printers using the Canon engine print normally receive
  138.      pages in reverse order because they stack printed side up.
  139.      Some have page handling mechanisms that stack them face
  140.      down, and in such a case -b will ensure that they come out
  141.      in order 1, 2, ... instead of n, n-1, n-2, ...
  142.      
  143. -c#     
  144.      Print # copies of each output page.  Page copies are printed
  145.      consecutively; this does not give multiple collated copies
  146.      of the entire job.
  147.      
  148. -d#     
  149.      Produce debugging output on `stderr' if a non-zero value is
  150.      given.  Multiple -d switches may be specified, and one may
  151.      also add values of the following possible options to obtain
  152.      the switch value:
  153.      
  154.      1     
  155.           (DVIJET only) print page bitmap in hexadecimal;
  156.      2     
  157.           display page coordinates and metrics of each output
  158.           character, and print each character bitmap in
  159.           hexadecimal;
  160.      4     
  161.           (DVIJEP only) display updated page coordinate of each
  162.           character after each call to `fixpos()';
  163.      8     
  164.           print filename and open mode of each successful file
  165.           opening;
  166.      16     
  167.           print filename and open mode of each unsuccessful
  168.           file opening;
  169.      32     
  170.           show discarded off-page text;
  171.      64     
  172.           trace virtual font caching;
  173.      128     
  174.           trace character setting (lots of output).
  175.      
  176.      For example, either -d8 -d16 or -d24 will trace all
  177.      attempted file openings.
  178.      
  179. -eVAR=value     
  180.      Define an environment variable on the command line (see the
  181.      later section Environment Variables).  The acceptable values
  182.      for `VAR' are `DVIHELP', `FONTLIST', `TEXFONTS', and
  183.      `TEXINPUTS'.  Under normal use of the translators, these can
  184.      be set by TOPS-20 and VAX VMS `define VAR: value' commands,
  185.      or by Unix `csh' `setenv VAR value' or `sh' `VAR=value'
  186.      commands.  When the translator is invoked by another
  187.      program, such as a print spooler, on some systems it may not
  188.      be possible to set a particular value of an environment
  189.      variable for the subprocess, so this option gets around this
  190.      limitation.  On most Unix systems, it should be possible to
  191.      use the call `system("VAR=value; dvixxx filename")'.
  192.      
  193. -ffontsubfile     
  194.      Define an alternate font substitution file which is to be
  195.      used instead of the default ones (see below).
  196.      
  197. -l     
  198.      Inhibit logging.
  199.      
  200. -m#     
  201.      Reset magnification to #.  The default for low resolution
  202.      printers is -m603, corresponding to 1/1.2**5 magnification
  203.      of 300-dot/inch fonts.  By TeX conventions, magnification
  204.      1000 corresponds to a 200-dot/inch output device.  The
  205.      default magnification is always adjusted according to the
  206.      output device resolution in order to give a normal page
  207.      size, so this parameter should rarely be required.  Legal
  208.      values are int((1000 or 1440 or 1500) x 1.2**{k/2}) (k =
  209.      -16...16); other values will be set to the nearest in this
  210.      family.  Not all fonts will be available in